<!doctype HTML public "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- Click to Convert 5.2: Anything to HTML -->
<!-- http://www.clicktoconvert.com -->

<html>
<head>
<title>gravityboxscheduleuserguide - page 125 of 234</title>
<meta http-equiv=content-type content=text/html;charset=iso-8859-1>
<meta name="Generator" content="Click to Convert">

<!--Start of page styles-->
<STYLE TYPE="text/css">
<!--
 /* Foreground Image Styles */

 /* Position Styles */
 .ts125p0{position:absolute;left:106px;top:97px;}
 .ts125p1{position:absolute;left:352px;top:97px;}
 .ts125p3{position:absolute;left:665px;top:97px;}
 .ts125p7{position:absolute;left:106px;top:113px;}
 .ts125p8{position:absolute;left:706px;top:1026px;}
 .ts125p9{position:absolute;left:331px;top:1044px;}
 .ts125p13{position:absolute;left:106px;top:146px;}
 .ts125p15{position:absolute;left:106px;top:164px;}
 .ts125p16{position:absolute;left:106px;top:183px;}
 .ts125p17{position:absolute;left:106px;top:201px;}
 .ts125p19{position:absolute;left:106px;top:220px;}
 .ts125p20{position:absolute;left:106px;top:238px;}
 .ts125p21{position:absolute;left:106px;top:256px;}
 .ts125p23{position:absolute;left:106px;top:275px;}
 .ts125p24{position:absolute;left:106px;top:293px;}
 .ts125p25{position:absolute;left:106px;top:312px;}
 .ts125p27{position:absolute;left:106px;top:330px;}
 .ts125p29{position:absolute;left:106px;top:348px;}
 .ts125p30{position:absolute;left:106px;top:367px;}
 .ts125p31{position:absolute;left:106px;top:385px;}
 .ts125p33{position:absolute;left:106px;top:404px;}
 .ts125p34{position:absolute;left:106px;top:422px;}
 .ts125p35{position:absolute;left:106px;top:440px;}
 .ts125p37{position:absolute;left:106px;top:459px;}
 .ts125p38{position:absolute;left:106px;top:477px;}
 .ts125p39{position:absolute;left:106px;top:496px;}
 .ts125p41{position:absolute;left:106px;top:514px;}
 .ts125p42{position:absolute;left:106px;top:532px;}
 .ts125p46{position:absolute;left:106px;top:551px;}
 .ts125p47{position:absolute;left:106px;top:569px;}
 .ts125p48{position:absolute;left:106px;top:588px;}
 .ts125p49{position:absolute;left:106px;top:606px;}
 .ts125p50{position:absolute;left:106px;top:624px;}
 .ts125p52{position:absolute;left:106px;top:643px;}
 .ts125p53{position:absolute;left:106px;top:661px;}
 .ts125p54{position:absolute;left:106px;top:680px;}
 .ts125p56{position:absolute;left:106px;top:698px;}
 .ts125p57{position:absolute;left:106px;top:716px;}
 .ts125p58{position:absolute;left:106px;top:735px;}
 .ts125p60{position:absolute;left:106px;top:753px;}
 .ts125p61{position:absolute;left:106px;top:772px;}
 .ts125p62{position:absolute;left:106px;top:790px;}
 .ts125p64{position:absolute;left:106px;top:808px;}
 .ts125p65{position:absolute;left:106px;top:827px;}
 .ts125p66{position:absolute;left:106px;top:845px;}
 .ts125p68{position:absolute;left:106px;top:864px;}
 .ts125p70{position:absolute;left:106px;top:882px;}
 .ts125p71{position:absolute;left:106px;top:900px;}
 .ts125p74{position:absolute;left:106px;top:919px;}
 .ts125p75{position:absolute;left:106px;top:937px;}
 .ts125p76{position:absolute;left:106px;top:956px;}
 .ts125p77{position:absolute;left:106px;top:974px;}
 .ts125p79{position:absolute;left:552px;top:568px;}
 .ts125p81{position:absolute;left:552px;top:580px;}
 .ts125p82{position:absolute;left:552px;top:592px;}
 .ts125p84{position:absolute;left:552px;top:605px;}

 /* Font Styles */
 .ft0p125{font-style:normal;font-weight:bold;font-size:13px;font-family:arial,sans-serif;color:#000000;}
 .ft1p125{font-weight:normal;}
 .ft2p125{font-style:normal;font-weight:normal;font-size:13px;font-family:"times new roman","times new roman",times,serif;color:#000000;}
 .ft3p125{font-style:normal;font-weight:normal;font-size:16px;font-family:"times new roman","times new roman",times,serif;color:#000000;}
 .ft4p125{font-style:normal;font-weight:bold;font-size:11px;font-family:arial,sans-serif;color:#000000;}
 .ft5p125{font-style:normal;font-weight:normal;font-size:16px;font-family:arial,sans-serif;color:#000000;}
 .ft6p125{font-style:normal;font-weight:bold;font-size:11px;font-family:arial,sans-serif;color:#FFFFFF;}
 .ft7p125{font-style:normal;font-weight:normal;font-size:11px;font-family:arial,sans-serif;color:#000000;}

 /* Background Style */
 .styleBackground125{position:absolute;left:105px;top:568px}

 /* Navigation Styles */
 .styleNavBarTop{position:absolute;left:0px;top:2px}
 .nb{position:absolute;left:2px;top:0px}
 .nbs{position:absolute;left:0px;top:0px}
 .nbe{position:absolute;left:836px;top:0px}
 .styleNavBarBot{position:absolute;left:0px;top:1117px}
-->
</STYLE>
<!--End of page styles-->

</head>
<body bgcolor="#ffffff" text="#000000" link="#0000FF" Vlink="#660099">

<table id="pageTable" width="836" STYLE="position: relative; left: auto; top: auto;"><tr><td>
<div class=nbs><img src="./navbarstart.gif" width="2" height="30"></div>
<div class=nb><img src="./navbar.gif" width="836" height="30" alt="Navigation bar"></div>
<div class=nbe><img src="./navbarend.gif" width="2" height="30"></div>
<div class=styleNavBarTop>
<table width="834" height="26" border="0" cellspacing="0">
  <tr align="left">
    <td width="4">&nbsp;</td>
    <td width="25" align="center"><a href="http://www.gravitybox.com" target="_parent"><img src="./home.gif" border="0" alt="Home"></a></td>
    <td width="25" align="center"><a href="#" onClick="window.open('./print.html','Printing','width=300,height=100,toolbar=no,directories=no');return false;"><img src="./print.gif" border="0" alt="Print document"></a></td>
    <td width="10" align="center"><img src="./separator.gif" border="0"></td>
    <td width="18" align="center"><a href="./index1.html"><img src="./start.gif" width="18" height="14" border="0" alt="Start"></a></td>
    <td width="18" align="center"><a href="./index124.html"><img src="./back.gif" width="14" height="14" border="0" alt="Previous page"></a></td>
    <td width="80" valign="middle"><table width="100%" height="16" border="0" cellspacing="1" bgcolor="#ACA899"><tr><td align="center" bgcolor="#ffffff"><font face=verdana,arial,sans-serif><font size="1">&nbsp;125 of 234&nbsp;</font></font></td></tr></table></td>
    <td width="18" align="center"><a href="./index126.html"><img src="./forward.gif" width="14" height="14" border="0" alt="Next page"></a></td>
    <td width="18" align="center"><a href="./index234.html"><img src="./end.gif" width="18" height="14" border="0" alt="End"></a></td>
    <td width="620">&nbsp;</td>
  </tr>
</table>
<p>
</div>
<nobr>
<div class=styleBackground125><img src="./background125.png" width="633" height="487" border="0" alt=""></div>
<div class=ts125p0><span class="ft0p125"> </span></div>
<div class=ts125p1><span class="ft0p125">Gravitybox Schedule Primer<span class="ft1p125"> </span></span></div>
<div class=ts125p3><span class="ft0p125">Page 123&nbsp; </span></div>
<div class=ts125p7><span class="ft2p125"> </span></div>
<div class=ts125p8><span class="ft3p125"> </span></div>
<div class=ts125p9><span class="ft4p125">1998&#45;2004 Gravitybox Software LLC<span class="ft3p125"> </span></span></div>
<div class=ts125p13><span class="ft5p125">well as the ScheduleItems collection, the appointments. The resolution of the select bar </span></div>
<div class=ts125p15><span class="ft5p125">scrolling is defined by the &#147;SubIncrement&#148; property. This must be less than or equal to </span></div>
<div class=ts125p16><span class="ft5p125">the ScheduleIncrement property. This is the smallest increment by which the select bars </span></div>
<div class=ts125p17><span class="ft5p125">will be moved when dragging. For example, if this value is set to 30, the user would find </span></div>
<div class=ts125p19><span class="ft5p125">that the defined area is rounded to 30 minute increments when dragging. As the user </span></div>
<div class=ts125p20><span class="ft5p125">moves the left select bar to the right, the SelectBarTime would move from &#147;9:00&#148; to </span></div>
<div class=ts125p21><span class="ft5p125">&#147;9:30&#148;, &#147;10:00&#148;, etc. The &#147;ScheduleIncrement&#148; property defines the time resolution </span></div>
<div class=ts125p23><span class="ft5p125">displayed on the top margin. If this value is set to 60 minutes then only hours will be </span></div>
<div class=ts125p24><span class="ft5p125">displayed in the top margin (&#147;9:00&#148;, &#147;10:00&#148;, etc) but with the SubIncrement set to 30 the </span></div>
<div class=ts125p25><span class="ft5p125">user may define an area of one hour from &#147;9:30&#148; and &#147;10:30&#148; with the select bars though </span></div>
<div class=ts125p27><span class="ft5p125">these times are not displayed on the top margin. </span></div>
<div class=ts125p29><span class="ft5p125"> </span></div>
<div class=ts125p30><span class="ft5p125">The most useful functionality of the control is to define an area to for appointment </span></div>
<div class=ts125p31><span class="ft5p125">creation. This is performed interactively with the user moving the select bars to define a </span></div>
<div class=ts125p33><span class="ft5p125">desired area, effectively to define a time block. The select bars identify a time slot that is </span></div>
<div class=ts125p34><span class="ft5p125">delineated by the &#147;SelectBarDate&#148;, &#147;SelectBarTime&#148;, and &#147;SelectBarLength&#148; properties. </span></div>
<div class=ts125p35><span class="ft5p125">These properties may be used by an application to create a default appointment on the </span></div>
<div class=ts125p37><span class="ft5p125">schedule control. This is not done automatically. You as the programmer have the </span></div>
<div class=ts125p38><span class="ft5p125">information needed to create an appointment and you must add the code to do so. </span></div>
<div class=ts125p39><span class="ft5p125">Since are as many add scenarios as there are software developers the </span></div>
<div class=ts125p41><span class="ft5p125">ScheduleSummary offers no predefined way to create an appointment. You may utilize </span></div>
<div class=ts125p42><span class="ft5p125">the user&#45;defined information to generate an appointment, creation routine. </span></div>
<div class=ts125p46><span class="ft5p125"> </span></div>
<div class=ts125p47><span class="ft5p125">When the user moves the mouse over either of the select </span></div>
<div class=ts125p48><span class="ft5p125">bars, the mouse pointer will turn to a vertical scroll icon. </span></div>
<div class=ts125p49><span class="ft5p125">This informs the user that he may grab a bar to resize the </span></div>
<div class=ts125p50><span class="ft5p125">defined area. As the user scrolls the select bars left or right, changing the defined time </span></div>
<div class=ts125p52><span class="ft5p125">area, the &#147;SelectionChanged&#148; event is raised to inform the calling a container of this </span></div>
<div class=ts125p53><span class="ft5p125">state change. You may use this information to update screen information if necessary or </span></div>
<div class=ts125p54><span class="ft5p125">not use it at all if your application has no use of it. Instead of the user scrolling to define </span></div>
<div class=ts125p56><span class="ft5p125">an appointment area, you may provide functionality to the user that searches for the </span></div>
<div class=ts125p57><span class="ft5p125">next available time slot. This means that there are no appointments defined for any </span></div>
<div class=ts125p58><span class="ft5p125">displayed provider. You may use this functionality with the &#147;SearchNextFreeSlot&#148; </span></div>
<div class=ts125p60><span class="ft5p125">method. When called this method searches for the next available slot taking into </span></div>
<div class=ts125p61><span class="ft5p125">consideration all appointments on the schedule. If one is found, the selection bars are </span></div>
<div class=ts125p62><span class="ft5p125">updated, the view is scrolled to bring the defined area in viewing range, and the method </span></div>
<div class=ts125p64><span class="ft5p125">returns true. If an available area is not found before the end of the schedule (the </span></div>
<div class=ts125p65><span class="ft5p125">maximum defined date) then the control&#146;s display does not change and the method </span></div>
<div class=ts125p66><span class="ft5p125">returns false. A limitation with using this control is that an increment that spans multiple </span></div>
<div class=ts125p68><span class="ft5p125">days will not be found using the &#147;SearchNextFreeSlot&#148; method. You may define a multi&#45;</span></div>
<div class=ts125p70><span class="ft5p125">day increment using the select bars but this method will not find a &#147;next&#148; slot using the </span></div>
<div class=ts125p71><span class="ft5p125">current select bar information. </span></div>
<div class=ts125p74><span class="ft5p125"> </span></div>
<div class=ts125p75><span class="ft5p125">You may also capture clicks that occur when the user clicks on a provider&#146;s name with </span></div>
<div class=ts125p76><span class="ft5p125">which you may wish to perform some action. When the user clicks on a provider&#146;s </span></div>
<div class=ts125p77><span class="ft5p125">name, the &#147;ProviderClick&#148; event is raised. The index of the provider in the Providers </span></div>
<div class=ts125p79><span class="ft6p125">Quick Tip </span></div>
<div class=ts125p81><span class="ft7p125">Automatically search for an available </span></div>
<div class=ts125p82><span class="ft7p125">appointment slot with the </span></div>
<div class=ts125p84><span class="ft7p125">&#147;SearchNextFreeSlot&#148; method. </span></div>
<div class=styleNavBarBot>
<table width="836" border="0" cellspacing="2">
  <tr></tr>
  <tr>
    <td width="118"><a href="http://www.purepage.com"><img src="./smalllogo.gif" width="118" height="46" border="0" alt="http://www.purepage.com"></a></td>
    <td></td>
  </tr>
</table>
</div>

</td></tr></table>

</body>
</html>
